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ABS TRACT 


A General computer program was designed, using the FORTRAN IV 
language, to utilize the IBM 2250 Display Unit in conjunction with the 
IBM System/360 Operating System. The user may adapt an associated 
program so that it may be an integral part of this general program. 
The general program provides the user with the ability to display a 
static information array and an input data array. The user may insert 
input data, for his associated program, from on-line input devices or . 
directly through the IBM 2250 alphameric keyboard and may change this 
data from the keyboard. The associated program may be executed repeat- 
edly, subject to system time constraints, and both alphameric and 
graphical output data from the associated program may be displayed 


after each execution, 
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IL. INTRODUCTION 


The use of visual display units associated with present generation 
computer systems creates a man-machine interface which allows the user 
to communicate directly with the computer, during the execution of hig 
program. As a teaching aid, the use of a visual display unit affords 
the visual presentation of information to the student as it is being 
discussed and computational results may be graphically displayed 
immediately, while the information is fresh in his mind. In addition, 
with the ability to change data or alter sequences of operations, 
comparisons may be rapidly made between various options in a problem 
to determine which may be relevant or where further investigation is 
warranted, 

The purpose of this thesis was to construct a general graphic 
display program for the IBM 2250 Display Unit. This equipment is 
associated with the IBM System/360 Operating System. This program is 
not limited in use as a teaching aid; its applicability may be 
extended to all situations where graphic display is desired. 

This thesis presents one method of utilizing the IBM 2250 Display 
Unit through a General FORTRAN Program called GFP. The GFP was 
designed such that another associated computer program may be iNeeT pO- 
rated, through appropriate modifications, as an integral part of the 
GFP. The input and output data from the associated program and the 
associated program may then be displayed on the screen of the display 
unit and changes to the input data may be made using the graphic display 


unit keyboard, 


The use of the GFP does not require that the wser have previous 
practical experience with the IBM designed Graphic Subroutine Package; 
however, it is expected that he be familar with the general informst cna 
concerning graphic programming services and the IBM 2250 as described 
in Ref. 2. It is to be remembered that this GFP is not a unique 
method for using the display unit, but only one possible aid for using 
this equipment. A person familar with graphic subroutines and func- 
tions could develop a graphic program suited exactly to the specific 
requirements of his problem, thereby making the best use of the capa- 
bilities of the display unit. This program, however, allows the 
relatively inexperienced user to take advantage of some of the capa-. 
bilities of the display unit, rather than none at all. 

The associated program which was used during the development of the 
GFP, and is included in the GFP listing in Appendix C, is a minesweeper 
simulation program, written by Professor A, F, Andrus and Miss P, R. 
Hoang of the Naval Postgraduate School. The complete description of 
this example associated program is provided in Ref. 1. This associated 
program was modified both for use with the IBM System/360 Operating 
System and the GFP. 

Chapter II provides a general description of the capabilities of 
the GFP, the graphic data sets, arrays, and the program function key- 
board keys used. Chapter III presents the detailed instructions, using 
the GFP listing in Appendix C, for making an associated program 
compatible with the GFP. Chapter IV provides a possible chain of 
events during the execution of the GFP and describes the physical 


operations which occur. 


Ii, DESCRIPTION OF THE GENERAL FORTRAN PROGRAM 


The General Fortran Program was written in accordance with the 
instructions as specified in Refs. 2 and 3. The design of the IBM 2250 
allows only for EBCDIC characters to be displayed on and read into the 
program from the screen of the Display Unit. Therefore, all data 
displayed on the screen must be in the A format. To overcome the 
obstacle of the input of numerical data and the display of numerical 
output data, computed by the associated program, a direct access disc 
storage device was utilized, This allows, with the use of input and 
output arrays, for an alphameric/numerical interface through appropriate 
read and write statements formatted for use with a direct access disc 
storage device. The DEFINE FILE statement in the GFP specifies direct 


access disc storage for this purpose, 


A. CAPABILITIES OF THE GFP 

In conjunction with an associated program, the GFP will allow the 
user to perform the following operations. 

1. A specified array of information may be read into the GFP and 
displayed on the screen in 25-line pages. 

2. The input data to be used by an associated program may be read 
into the GFP and displayed, This data will be displayed in 20-line 
pages. The user may also enter this data directly from the alphameric 
keyboard or modify data which was previously read. 

3. The associated program may be executed and re-executed as 
desired, subject to system restrictions on total allowable execution 


time of the GFP. 


4, A rectangular coordinate system grid may be displayed and 
labeled. The graphical data limits of the lines to be drawn on this 
graph must be specified by the user. 

5. Output data, both tabular and graphical, from the associated 
program may be displayed. The tabular data is displayed in 25-line 
pages. The two line graphs, labeled "1" and ''2,'' may be displayed 
simultaneously. 

6. The input and output data, which was used and produced by the 


associated program, may be printed on the line printer. 


B. GRAPHIC DATA SETS 

The GFP utilizes three graphic data sets named IGDS1, IGDS2, and 
IGDS3. IGDSl1 encompasses the lower half of the screen and is used for 
all alphameric input and output displays. IGDS2 encompasses the upper 
half of the screen and is used to display rectangular coordinate graph 
axes and the desired numerical scales and labels for these axes. The 
data for the line graphs is generated by the associated program. The 
axes are permanently displayed in the center of the IGDS2 area, the 
length of each axis being four tenths of the length of the entire 
screen. IGDS3 encompasses that square screen area bordered on the left 
and bottom by the permanently displayed axes which were initialized in 
I@S2., The intersection of the two axes is the lower left corner of 
IGDS3. The data limits for IGDS3 are variable and detailed instruc- 
tions for setting these limits are discussed in Chapter III. Figure l 


shows the locations of the graphic data sets on the display screen. 


C. DATA ARRAYS 


The GFP uses eight arrays for storage of the user's input data and 


the output data from the associated program. These arrays are named 


IGDS2 AREA 


IGDS1 AREA 





Figure l 


Location of Graphic Data Sets on Screen 


INPUT1, INPUT2, OUT1, OUT2, OUT3, OUT4, OUTS, and O26, INPUT1, INPUT2, 
and OUT1 arrays are blanked out by a data statement upon initial 
execution of the GFP. The following paragraphs present a description 
of these eight arrays, 

The INPUT1 array is dimensioned for 500 lines of 18 words, each 
word containing four characters. The user may utilize this array for 
display of the associated program or other alphameric information in 
IGDS1. This is a static array; the information must be read in at the 
beginning of the program and stored for subsequent display. INPUT1L 
cannot be used for other than this purpose. 

The INPUT2 array is dimensioned for 50 lines of 18 words, each word 
containing four characters. Its use is to store input data utilized by 
the associated program. This data may be displayed in IGDS1, changed 
by use of the alphameric keyboard if desired, and may be transferred 
into the direct access storage disc by the user. The data in this 
array may also be printed on the line printer if desired. 

The OUTIL array is dimensioned for 350 lines of 18 words, each word 
containing four characters, It is the storage array for alphameric 
data output from the associated program, The information in this array 
may be displayed in IGDS1, printed on the line printer, or blanked out 
as desired by the user. Blanking out of this array after an execution 
of the associated program would erase all previous data, and would pre- 
clude the possibility of displaying or printing erroneous output data 
after the next execution of the associated program. 

The OUT2 array is dimensioned for one line of 18 words, each word 
containing four characters. It is the storage array for one line of 


data from the INPUT2 array which is determined to be in error by the 
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associated program. The associated program must have a method to check 
input data for correctness, as in the example associated program in 
Appendix C, and to read that line of data into the array, if this array 
is to serve any purpose. 
The OUT3 array is dimensioned for ten words and is the storage 
array for the dependent variable for graphical display in IGDS3. The 
array is filled directly during the execution of the associated program. 
The OUT4 array is dimensioned for ten words and is the storage 
array for the independent variable for graphical display in IGDS3. 
The array is filled directly during execution of the associated program. 
This array, in conjunction ne the OUT4 array, provides the data 
points for display of the line graph labeled "1," 
The OUT5 and OUT6 arrays are dimensioned for ten words and are 
used to store the data in the OUT3 and OUT4 arrays respectively. These 
arrays provide data points for display of the graph labeled ''2."' Since 
the values in OUT3 and OUT4 arrays are set during execution of the 
associated program, arrays OUT5 and OUT6 provide storage for data points 
from a previous execution of the associated program. Both graphs "1" 


and '2"" may be displayed simultaneously for comparison. 


D. DISPLAY IN IGDS1 AREA 

The INPUT1 or OUT2 array data may be displayed on the screen in 
25-line increments, and the INPUT2 array data may be displayed on the 
screen in 20-line increments. These increments will be referred to as 
pages. Through the use of the applicable keys on the program function 
keyboard, these pages may be advanced or rewound to allow for display of 
the entire contents of any of the three arrays. The advance and rewind 


operations may be accomplished in ten or one page increments or ten and 
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five line increments. The display of the last set ot data in an array 
will occupy less than a full page when the number of lines of data in 
this set is less than the number of lines on a page. For example, in 
the example associated program there are 34 lines of data in the INPUT2 
array. The first page displayed will include the first 20 lines, but 
after advancing the display one page, only 14 lines will be displayed, 
lines 21 through 34. If, while advancing the pages in an array, the 
number of the first line to be displayed is advanced beyond the speci- 
fied limits of that array, a message will be displayed indicating the 


end of the input/output array. 


E. PROGRAM FUNCTION KEYBOARD 

The GFP uses 29 function keys. The use of each key is described 
below. 

Key 1 has two uses. Its primary use is to display the first 25 
lines of data, stored in the INPUTI1 array, in the IGDSI1 area. In 
addition, when used immediately after any of keys 2 through 9 or ll, 
the specified 25 lines data in the INPUT1 array is displayed in IGDS1. 

Key 2 has two uses. Its primary use is to advance the line 
counters, which determine the next array segment to be displayed in 
IGDS1, ten 25-line pages beyond their present positions. When used 
immediately after any of keys 2 through 9 or 11, the specified 20 lines 
of data in the INPUT2 array is displayed in IGDS1. 

Key 3 has two uses, Its primary use is to reset the line counters, 
which determine the next array segment to be displayed in IGDSI, ten 
25-line pages back from their present positions. When used immediately 
after any of keys 2 through 9 or 11, the specified 25 lines of data 


in the OUT1 array is displayed in IGDSI. 
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Key 4 advances the line counters, which determine the next array 
segment to be displayed in IGDS1, one 25-line page beyond their present 
positions, 

Key 5 resets the line counters, which determine the next array 
segment to be displayed in IGDS1, one 25-line page back from their 
present positions. 

Key 6 advances the line counters, which determine the next array 
segment to be displayed in IGDS1, ten lines beyond their present 
positions. 

Key 7 resets the line counters, which determine the next array 
segment to be displayed in IGDSI1, ten lines back from their present 
positions. 

Key 8 advances the line counters, which determine the next array 
segment to be displayed in IGDS1, five lines beyond their present 
positions, 

Key 9 resets the line counters, which determine the next array 
segment to be displayed in IGDS1, five lines back from their present 
positions. 

Key 10 displays in IGDS1 the first 20 lines of the input data 
stored in the INPUT2 array. It also displays the instructions for 
changing the data in the INPUT2 array. 

Key 11 advances the line counters, which determine the next array 
segment to be displayed in IGDS1, 20 lines beyond their present 
positions. This key is designed to assist in advancing the data in the 
INPUT2 array by one page increments because the specified page length 


for INPUT2 array data is 20 lines rather than 25 lines. 
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Key 12 displays a cursor under the first character position in the 
first line of displayed INPUT2 data. This key is only used when INPUT2 
data is displayed. 

Key 13 advances the cursor one line and displays the cursor under 
the first character of the next Line, 

Key 14 removes the cursor from the display. 

Key 15 transmits the page of displayed INPUT2 data into the INPUT2 
array. If this data has been changed on the display screen with the 
alphameric keyboard, the new data is stored in the INPUT2 array. This 
data must be read into the INPUT2 array before the next page of data is 
displayed. 

Key 16 transfers the data in the INPUT2 array to the direct access 
disc storage area, The associated program reads its input data from 
this intermediate disc storage space. 

Key 17 blanks out the OUT1 designated section on the direct access 
storage disc. This key should be used only after using key 18 to pre- 
vent the loss of output data produced during execution of the associated 
program. 

Key 18 transfers the alphameric data output from the direct access 
disc storage to the OUTIL array. 

Key 19 displays the first 25 lines of data, stored in the OUTIL 
array.in I¢pol 

Key 20 displays the axes and labeling for the graphical output in 
IGDS2, and displays a cursor under the top zero in the column of zeros 
alongside the vertical axis. This zero may be changed by use of the 


alphameric keyboard. 
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Key 21 advances the cursor to the next designated line in IGDS2, 
and displays the cursor under the first character in that line. 

Key 22 blanks out IGDS3. Keys 23 or 25 must be used to display a 
line in IGDS3. At the beginning of execution of the GFP an initializa- 
tion line is displayed diagonally across IGDS3. The use of this key 
will remove that line when it is desired to display a graph. 

Key 23 displays a line graph in IGDS3, utilizing data in OUT3 and 
OUT4 arrays, and labels this graph "1." 

Key 24 transfers data stored in the OUT3 and OUT4 arrays to the 
OUT5 and OUT6 arrays respectively. 

Key 25 displays a line graph in IGDS3, utilizing the data in OUT5 
and OUT6 arrays, and labels this graph "2.'' The two line graphs, 
labeled "1" and "2" may be displayed simultaneously. Additional graphs 
may be simultaneously displayed but will be labeled "1" or "2," There- 
fore, to display more than two graphs, the user will need to use a 
mechanical method to determine which data produced the additional line 
graphs. If the user uses key 22, only the data stored in the OUT3/OUT4 
and OUT5/OUT6 arrays will be available to produce line graphs until 
another execution of the associated program is completed. 

Key 26 transfers to the line printer, the current contents of the 
input data stored in the INPUT2 array. 

Key 27 transfers to the line printer, the current contents of the 
output data stored in the OUTI array. 

Key 28 initializes the execution of the associated program. 


Key 29 terminates the GFP. 
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III. ASSOCIATED PROGRAM COMPATABILITY REQUIKEMENTS 


This chapter describes, in detail, the requirements to make an 
associated program compatable with the GFP. The GFP program is con- 
tained in Appendix C and direct referral will be made to this program 


using the line index numbers. 


A. GENERAL 

The GFP manipulates and displays the data to and from the associated 
program. It provides intermediate direct access disc storage space of 
800 lines, each of 72 characters in length. This disc space is used to 
temporarily store INPUT2, OUT1, and OUT2 data during execution of the 
GFP. The GFP transfers the input data in the INPUT2 array to disc 
storage. The associated program, then, must read this data from the 
disc storage in a manner similar to that in the INPUT SUBROUTINE, line_ 
462, in the example associated program. The associated program must 
store alphameric output data, for later transfer by GFP to the OUTIL 
array, on intermediate disc space in a manner similar to that in the 
TITLE SUBROUTINE, line 587, in the example associated program. The 
associated program must store the line of improper input data, if any, 
on intermediate disc storage space and transfer this to the OUT2 array 
in a manner similar to that in the INPUT SUBROUTINE, lines 576 through 
579, in the example associated program. The associated program must 
also store numerical data in the OUT3 and OUT4 arrays for use in the 
display of line graphs. 

The user must always set the variables NMAX, NDATA, MAXOUT, Nl, 


GR1, GR2, GR3, and GR4, described in section C of this chapter, to 
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correspond to the requirements of his associated program. The GFP 

may be utilized without further modifications if the user reads external 
data into GFP for the INPUT1 and INPUT2 arrays and the total number of 
72-character lines of data stored in the INPUT1, INPUT2, OUT1, and OUT2 
arrays are less than or equal to 500, 50, 350, and 1 respectively. In 
addition, the number of data point sets to be utilized for any line 


graph must not be greater than ten. 


B. DIMENSIONING OF ARRAYS 

The GFP utilizes the arrays described in this paragraph exclusively 
and their dimensions must not be changed. The one word array NULL is 
required for use as the null variable. The one word array IBIT is 
required for storage of light pen attention or end-order-sequence infor- 
mation by the Request Attention Information subroutine. The one word 
array IT is required for storage of information related to the comple- 
tion of the read operation in the Read Text subroutine. The array IKEY 
is required for identification of elements associated with the Plot 
Text, Insert Cursor, and Read Text subroutines and must be dimensioned 
for 25 words, the maximum number of lines displayed in IGDS1 at any 
time. 

It may be necessary for the user to modify the dimensions of the 
INPUT and OUT arrays, either by decreasing some of them to reduce total 
core requirements for the GFP with an integrated associated program, or 
by increasing some of them to provide sufficient storage space for the 
desired input and output data. If this situation occurs, the following 
changes to the arrays and associated program variables are necessary to 


ensure associated program compatability. 


wy 


If the sum of the second dimensions of INPUT2 ani OUT1, and OUT2 
arrays are greater than 800, the second dimension of the DEFINE FILE 
statement, line 36, must be appropriately increased. Because of tie 
format of the read and write statements in the GFP, the first dimension 
of INPUT1L, INPUT2, OUT1, and OUT2 arrays should not be changed from 18 
and the second dimensions must be at least one. If the second dimension 
of the INPUT2 array is increased beyond 50 and/or the second dimension 
of OUT1 array is increased beyond 350, it will be necessary to insure 
that no intermediate disc storage records are inadvertantly overwritten. 
In line 379 of the example associated program, the variable W defines 
the first location for storing the OUTI1 array on the disc. The user 
must specify the value of the corresponding variable in his associated 
program such that it is one greater than the value of the second 
dimension of the INPUT2 array. In lines 249 and 260, the variable I 
values must also range from one more than the value of the second 
dimension of the INPUT2 array to the sum of the second dimensions of 
INPUT2 and OUT1 arrays, to ensure proper blanking out or reading in of 
data. Also, as in lines 576 and 579 in the example associated program, 
the user must specify in the corresponding statement in his associated 
program that the initial location for storing the data for the OUT2 
array be one greater than the sum of the second dimensions of the 
INPUT2 and OUT1 arrays. If the dimensions of INPUT1, INPUT2, or OUTIL 
arrays are changed, corresponding changes will be required for initial 
blanking out of these arrays by the DATA statement, line 32. 

The dimensions of OUT3, OUT4, OUT5, and OUT6 arrays are determined 


by the number of points to be used for displaying each line graph in 
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IGDS3. The dimensions of these arrays should be increased, if necessary, 


and they should all be dimensioned the same value. 


C. SPECIFIC VARIABLE INITIALIZATION 

In lines 43 through 50, initialization variables are specified. 

NMAX specifies the actual number of lines of data used in the INPUTI1 
array. NDATA is the actual number of lines of data in the INPUT2 array 
and MAXOUT is the actual number of lines in the OUTl array. These 
three variables determine the operations to be performed in lines 80, 
86, 115, 182, 241, 269, 362, and 370. It is also necessary that the 
second dimensions in INPUT1L, INPUT2, and OUT1 arrays be greater than or 
equal to the values of NMAX, NDATA, and MAXOUT respectively. 

Nl is the variable designating the number of lines to be drawn on 
each line graph. The number of points to be stored in OUT3, OUT4, OUT5, 
and OUT6 arrays must be one more than this number. The first point in 
these arrays will be the initial starting positions for the line graphs. 

The variables GR1 and GR2 designate the X and Y values respectively 
at the lower left corner of IGDS3, which is the intersection of the 
line graph axes. GR3 and GR4 designate the maximum X and Y values 
respectively of the data range of the line graphs, and is the upper 
right corner of IGDS3. GR1, GR2, GR3, and GR4 must be chosen by the 
user according to the specific requirements of his associated program. 


The GFP automatically scales the graph area for these values, line 65. 


D. EXTERNAL INSERTION OF INPUT DATA 
The reading of data into INPUT] and INPUT2 arrays, lines 80 through 
88, is optional and these statements may be left out of the GFP. If 


they are removed, then function keyboard key number one will have no 
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use and the INPUT2 data will have to be inserted trom the alphameric 


keyboard with the use of the cursor. 
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IV. SAMPLE GFP EXECUTION CHAIN OF EVENTS 


This chapter describes one complete chain of events during execution 
of the GFP. This description will assume that all of the capabilities 
of the GFP will be utilized. It is to be remembered that the user is 
not required to follow this sequence exactly to utilize the GFP, and 
that multiple sequences of events may be utilized for multiple execu- 
tions of the associated program, This chapter will also indicate 
faulty sequences which will prevent the user from obtaining his desired 
graphical display. Reference to the GFP program listing in appendix C 
will be made by line index number, 

Upon initial execution of the GFP the INPUT1, INPUT2, and OUTIL 
arrays are blanked out, intermediate disc storage is defined and basic 
parameter variables are initialized, lines 32 through 50. The 2250 is 
initialized and the statement ''GENERAL FORTRAN PROGRAM" is displayed in 
the center of IGDS1. A horizontal line is displayed across the bottom 
edge of IGDS2 and a diagonal line is displayed from the lower left 
corner to the upper right corner of IGDS3 for initialization. Data is 
read into INPUT1 and INPUT2 arrays. These reading operations are 
optional. The alarm, which is a short duration tone, is sounded. The 
keys 1 through 29 are enabled and the lights in these keys are lighted 
to indicate theyare enabled. The program waits at this point for 
attention information provided by the user with the program function 
keyboard. Unless otherwise specified during the remainder of the 
discussion in this chapter, the program will return to line 92 and wait 


for the next attention information, at the completion of each operation, 
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A. DISPLAY OF INPUT1L ARRAY 

The sequence of events for displaying INPUT1 information is listed 
below. A complete explanation of all of the computer operations for 
this process is described below the list. 

1. Push key l 

2. Push one of keys 2 through 9° 

3. Repeat steps 1 and 2 as desired 
Key 1 is pushed by the user and the first 25 lines of information, or 
the number specified in the variable NMAX, if it is less than 25, 
stored in INPUT1 array is displayed in IGDS1. The user then pushes any 
of keys 2 through 9 to reset the page to be displayed. The use of keys 
2 through 9 resets the values of the variables NA and NB and the program 
goes to line 104 and disables all keys except 1, 2, and 3. The previous 
display will remain and the lights in the disabled keys will be turned 
off. Since the INPUT1 information is being displayed, key 1 will be 
pushed next and the new 25-line segment of INPUT1 information will be 
displayed, The program will go to line 92, enable and light all keys 1 
through 29 again, and wait for the next attention information. It 
should be noted at this time that when only keys 1, 2, and 3 are enabled, 
any of these keys may be pushed. If key 2 is pushed, only the 20-line 
segment in the INPUT2 array with the first line corresponding to the 
present value of NA will be displayed. If key 3 is pressed, the 25-line 
segment in the OUTI1 array corresponding to the present values of the 
variables NA and NB will be displayed. Therefore, the user must push 
the proper key to display the desired information. The procedure of 
displaying successive pages of INPUT1 information may be continued by 


repeating the two-step procedure described above. When the value of 
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the variable NA is incremented to a value greater than the specified 
value of NMAX, the program control is transferred to line 408 and the 
statement, "END OF INPUT/OUTPUT ARRAY USE PROGRAM FUNCTION KEYBOARD TO 
RETURN TO DESIRED PORTION OF PROGRAM," is displayed. Program control 


then returns to line 92 and waits for the next attention information. 


B. DISPLAY, CHANGING AND STORING OF INPUT2 DATA 

The next sequence is to display, change, and store INPUT2 data as 
follows: 

1. Push key 10 

2. Push key 12 

3. Push key 13 

4. Repeat steps 2 and 3 as desired 

5. Push key 14 

6. Push key 15 

7. Push key 11 if additional pages of INPUT2 data are to be inserted 

8. Push key 2 

9. Repeat steps 2 through 6 as desired 

10. Push key 16 
The user pushes key 10 to display the first 20 lines, or the number of 
lines specified by the value of the variable NDATA if it is less than 
20, in IGDS1. In addition, the statements, "TO MODIFY OR ENTER DATA 
INSERT CURSOR."' and "REMOVE CURSOR WHEN EDITING IS COMPLETED," are 
displayed at the top and bottom respectively of IGDS1. If no INPUT2 
data is read in initially, the IGDS1 area will be blank except for the 
above statements. By pushing key 12, the cursor will be displayed under 
the first character position in the first line of INPUT2 data. The use 


of key 13 advances the cursor one line. The user may change the input 
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data by proceding to the desired line and, by use of the advance key on 
the alphameric keyboard, position the cursor under the desired character 
to be changed, After typing in the new character from the alphamezvic 
keyboard, the cursor will advance one space. If no initial INPUT2 data 
was read, the user will type in his complete page of data. Upon 
completion of the desired changes on a page of INPUT2 data, the user 
pushes key 14. This is not necessary but will prevent the user from 
inadvertantly striking a key on the alphameric keyboard which would 
change the character where the cursor was positioned. The user then 
pushes key 15 which reads the displayed data into the INPUT2 array and 
sounds the alarm. This key must be pushed before the display is ad- 
vanced or the changed data will not be entered into the INPUT2 array. 
If no changes had been made to the data previously read, this operation 
would not affect the data already in the array. The above sequence of 
operations may be repeated to change or insert additional pages of 
INPUT2 data by pushing key 11 which advances NA and NB by 20-line 
increments, pushing key 2, and making desired changes or insertions. 
If the value of the variable NA is increased to a value greater than 
the value of the variable NDATA, the end of input/output array message 
will be displayed in IGDS1. Upon the completion of all input changes 
or the typing of all INPUT2 data, key 16 is pushed to transfer this 
data to intermediate disc storage from which it may be utilized by the 
associated program. The alarm is again sounded to indicate completion 
of this operation. 

Key 28 is pressed to execute the associated program. The user may 
utilize an input data checking procedure in his associated program 


which places a line of improper data into the OUT2 array and returns 
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control to GFP. If this checking procedure is used and the input data 
is in error, the program will return to line 432, print the following 
statements, ''FOLLOWING DATA CARD CONTAINS ILLEGAL NAME,'' the line of 
improper data from the OUT2 array, and "USE PROGRAM FUNCTION KEYBOARD 
TO RETURN TO DESIRED PORTION OF PROGRAM,'' in IGDS1, and sound the alarn. 
If the data is correct or no data checking procedure is used and the 
associated program completes execution, the program will return to line 
420, display the following statement in IGDS1, "ASSOCIATED PROGRAM 
EXECUTION COMPLETED USE PROGRAM FUNCTION KEYBOARD TO RETURN TO DESIRED 


PORTION OF PROGRAM,'' and sound the alarm, 


C. DISPLAY OF OUTIL DATA 

Upon completion of the execution of the associated program, the 
user may utilize the following sequence of keys to display OUT1 data. 

1. Push key 18 

2. Push key 17 if desired 

3. Push key 19 

4, Push one of keys 2 through 9 

Die egUishieicey aS 

6. Repeat steps 4 and 5 as desired 
The user pushes key 18 to transfer the alphameric output from the 
intermediate disc storage to the OUT1 array. The alarm will sound to 
indicate completion of this operation. This data may be displayed in 
IGDS1 in a similar manner as stated previously for the display of 
INPUTL information. Key 19 is pushed to display the first 25 lines of 
data in the OUT1 array in IGDS1, or the value of the variable MAXOUT 
if it is less that 25. Any of keys 2 through 9 may now be pushed to 


reset the values of the variables NA and NB and will disable all 
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program function keys except l, 2, and 3. Key 3 “~c be pushed next to 
display the desired segment of the OUTI1 array. When the value of the 
variable NA is incremented to a value greater than the specified velv- 
of the variable MAXOUT, the end of input/output array message will be 
displayed in IGDS1. It should be noted that if key 17 is pushed after 
the completion of execution of the associated program and before pushing 
key 18, the alphameric output data from that execution will be lost by 
the blanking out of that portion of the intermediate disc storage 
reserved for the output data. Therefore, key 17 should be used only 


after key 18 is pushed. 


D. GRAPH LABELING 

The user may label the graph to correspond to the associated pro- 
gram data by the following sequence, 

1. Push key 20 

2. Push key 21 

3. Repeat step 2 as desired 
Key 20 is pushed to display the line graph axes and general labeling. 
The labels consists of the following characters. Immediately to the 
left of the vertical axis is a column of ll equally spaced zeros. To 
the left of the column of zeros are two lines with the words, ''DEPENDENT" 
and "'VARIABLE.'' Below the horizontal axis are two lines of characters; 
first is a row of 11 equally spaced zeros and below this line another 
line with the words, ''INDEPENDENT VARIABLE," In addition to the dis- 
play of axes and labeling, a cursor is inserted beneath the uppermost 
zero in the column of zeros. Key 21 may be pushed to advance the cursor 


to the next designated line. The specific labeling of the graph may be 
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accomplished through the use of the alphameric keyboard, in the follow- 
ing sequence. 

1. The 11 zeros to the left of the vertical axis are changed 
individually be selecting the desired characters from the keyhoard to 
replace the zero indicated by the cursor. Key 21 is then pushed which 
places the cursor under the next zero. This procedure is repeated until 
all 11 zeros are changed to the desired values. Two characters may be 
placed on each of these lines. 

2. At the completion of (1) push key 21, which places the cursor 
under the first zero below the horizontal axis, and change this entire 
line as desired to scale the horizontal axis. 

3. At the completion of (2) push key 21, which places the cursor 
under the first character in the line ''DEPENDENT", which is to the left 
of the vertical axis. The characters of this line may now be changed 
as desired, 

4, At the completion of (3) push key 21, which places the cursor 
under the first character in the line "VARIABLE," which is directly 
under the line in (3) above, This line may now be changed as desired. 

5. At the completion of (4) push key 21, which places the cursor 
under the first character in the line ''INDEPENDENT VARIABLE" below the 
horizontal axis. This line may now be changed as desired. 

The use of key 20 after the graph has been laheled by the user will 
reset the labels to the original characters displayed when key 20 was 


originally pushed, 


E, DISPLAY OF LINE GRAPHS 
The user may display a line graph in the following sequence. 


1. Push key: 22 
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2. Push key 23 

3. Push key 24 if desired 

4, Push key 22 if associated program is executed two or more <ziires 

5. Push key 23 

6. Push key 25 
Key 22 is pushed to remove the diagonal line from IGDS3. Key 23 is 
pushed to display line graph labeled "1" in IGDS3. If it is desired 
to save the data for this line graph for comparison with data from 
future executions of the associated program, key 24 must be pushed to 
transfer the data to the OUT5 and OUT6 arrays. The alarm will sound to 
indicate completion of this operation. The line graph labeled "2," 


using the data in OUT5 and OUT6 arrays may be displayed by using key 25. 


F, PRINTING OF INPUT2 AND OUTIL ARRAYS ON LINE PRINTER 

The data in INPUT2 and OUTI1 arrays may be written on the line 
printer by pushing keys 26 and 27 respectively. The alarm will sound 
after each of these operations to indicate their completion. 

This essentially completes the sequence of events in the execution 
of the GFP. If additional executions of the associated program are 
desired, the above sequences may be repeated. 

When all desired operations are completed, the user will push key 
29 which will completely terminate the execution of the GFP and the use 
of the 2250 for that program. 

It should be remembered that this sample chain of events is only an 
aid to understanding the operations performed by the GFP. The user may 
utilize these operations in the order which satisfies his needs, limited 
by the few sequences indicated in this chapter which would prevent him 


from obtaining his desired output. 
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V. SUMMARY AND RECOMMENDATIONS 


The GFP provides the user with an aid to utilizing the IBM 2250 
Display Unit. The user may display a static array of information, 
enter, display and change input data to be utilized by the associated 
program and display alphameric and line graph data from the associated 
program. This provides the user with the ability to utilize the GFP 
with a wide range of associated programs and to obtain rapid display 
of computational results. In additionl the GFP may assist the in- 
experienced user to gain familiarity with the display unit and its 
capabilities. 

It was noted during the development of this program that many 
variables and arrays had to be preset in the GFP and could not be 
changed during its execution. One possible solution to this problem 
may be to develop an initialization computer program which could read 
the desired GFP variable values and array dimensions as data, calculate 
necessary intermediate disc storage locations and then compile and 
execute the GFP. With this capability, the GFP would require no 
changes for individual associated programs and, in addition, could be 
modified to include additional variables which would automatically 
specify storage locations for the associated program. It is recom- 
mended that further study be conducted in this area to determine the 


feasibility of this type program. 
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APPENDIX B 
‘LIST OF VARIABLES USED BY GFP 


Real variable used in conjunction with the variable B to 
alter the screen position to display a line of INPUTI1 data 
in IGDS1. 

Real variable, the value of which denotes the Y-coordinate 
of the intemal starting position to display a line of infor- 
mation from INPUTI in IGDS1. 

Real variapes used in conjunction with the variable D to 
alter the screen position to display a line of INPUT2 data 
in IGDS1. 

Real variable, the value of which denotes the Y-coordinate of 
the initial Parting position to display a line of informa- 
tion from INPUT2 in IGDS1. 

Real variable used in conjunction with the variable F to 
alter the Ried position to display a line of OUTI1 data in 
IcDs1. 

Real variable, the value of which denotes the Y-coordinate of 
the initial starting position to display a line of informa- 
tron, from OUTl anelepsl. 

Real variable used in conjunction with the variable H to 
alter the screen position to display a zero on the vertical 
axis in IGDS2. 

Real variable, the value of which denotes the X-coordinate 


of the lower left corner of IGDS3. | 
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GR2 


GR3 


GR4 


IATL 


IBIT 


IBUTT 


IGDS1 


IGDS2 


Real variable, the value of which denotes the Y-coordinate 
of the lower left corner of IGDS3. 

Real variable, the value of which denotes the X-coordinate 
of the upper right corner of IGDS3. 

Real variable, the value of which denotes the Y-coordinate 
of the upper right corner of IGDS3. 

Real variable, the value of which denotes the Y-coordinate 
of the initial starting position to display a zero on the 
vertical axis in IGDS2. 

Dummy integer variable for temporary storage throughout the 
program, 

Integer variable to which a value is assigned by the CRATL 
Subroutine to identify the attention level created by this 
call. 

Variable identifying a ten-word array into which the RQATN 
Subroutine places additional information about light pen or 
end-of-order sequence attentions, 

Integer variable to which the RQATN Subroutine assigns a 
value to identify the source of the attention information 
being returned, 

Integer variable to which a value is assigned by the INGDS 
Subroutine to identify the graphic data set to be created 
by this call. 

Integer variable to which a value is assigned by the JNGDS 
Subroutine to identify the graphic data set to be created by 


this call. 


5) 


IGDS3 


IGSP 


IT 


12250 


MAXOUT 


NA 


Integer variable to which a value is assisned by the INGDS 
Subroutine to identify the graphic data set to be created by 
this call. 

Integer variable to which a value is assigned by the INGSP 
Subroutine for initialization of the graphic subroutine 
package, 

Integer variable to which a value is assigned by the GSPRD 
Subroutine to identify the reason why the subroutine was 
terminated. 

Integer variable to which a value is assigned by the INDEV 
Subroutine to identify the 2250 initialized by this call. 
Dummy integer variable for temporary storage throughout the 
program. 

Dummy variable for temporary storage. 

Integer variable to which is assigned a value by GSP, to 
specify the key value in the PTEXT or GSPRD Subroutines, of 
a particular line of data displayed in IGDS1 or read into 
TNPU TZ Sarna. 

Integer variable, the value of which is used by GSP to deter- 
mine the particular line under which to display the cursor 
by the ICURS Subroutine. 

Integer variable, the value of which denotes the actual 
number of lines used in OUTIL array. 

Integer variable, the value of which denotes the first line 
in a sequence of information from a desired array, to be 


displayed in IGDS1. 
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NB 


NDATA 


NMAX 


N1 


N2 


Integer variable, used in conjunction with NA and the value 
of which denotes the last line in a sequence of information 
from a desired array, to be displayed in IGDS1. 

Integer variable, the value of which denotes the actual 
number of lines used in INPUT2 array. 

Integer variable, the value of which denotes the actual 
number of lines used in INPUT1 array. 

Integer variable, the value of which denotes the number of 
lines drawn for each line graph in IGDS3. 

Integer variable, the value of which denotes the number of 
points utilized to draw a line graph in IGDS3. 

Real variable, the value of which denotes the X-coordinate 
of a particular point for displaying a line graph in IGDS3. 
Real variable, the value of which denotes the Y-coordinate 


of a particular point for displaying a line graph in IGDS3. 


ayy 


APPENDIX C 


GFP COMPUTER PROGRAM LISTING 


This appendix provides a complete listing of the GFP and includes 


the example associated program, 
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